home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr34 / tarchiv.zip / README < prev    next >
Text File  |  1995-01-27  |  6KB  |  176 lines
  1. TARCHIVE - File/Tape Archiver Program - Ver 1.2B
  2. by Andreas Schiffler - University of Saskatchewan
  3. ============================================================================
  4.  
  5. Introduction
  6. ------------
  7.  
  8. Tarchive is a DOS command-line tape archiver program for the Exabyte 8500 or
  9. 8505 tape drives operating in the 4.9 GByte mode. This program is meant to
  10. replace the TAR program and enhance it by using some of the specific
  11. features of the EXB-8500 family of tape drives. This means that this program
  12. will not work with the older Exabyte 8200 drives since they do not support
  13. the SCSI-commands used by Tarchive. DAT drives should however work, if they
  14. support block-seek commands (this is not tested). Tarchive is not TAR
  15. compatible, but uses its own format for increased speed and security of the
  16. archiving process.
  17. Also provided are sources for a tape-erase program and a simple file
  18. archiver.
  19.  
  20. Features
  21. --------
  22.  
  23. * fast save and backup operation through use of buffering mode and large
  24. blocksize
  25. * directory information of each saveset is kept with saveset for quicker
  26. access of individual files
  27. * fast file retrieval by use of direct data-block search
  28. * increased data security by use of a magic code in header and a checksum
  29. * advanced error checking implemented for Exabyte drives
  30. * extensive error logging possible
  31. * filename-list mode for simple interfacing with other programs
  32. * tape erase/conditioning program is included
  33.  
  34. Disadvantages
  35. -------------
  36.  
  37. * the format is not TAR compatible
  38. * does not store path information
  39. * number of files per saveset limited (approx. 15 thousand)
  40.  
  41. Command line usage
  42. ------------------
  43. | means or, <...> means substitute value, [...] means optional
  44.  
  45.    TARCHIVE a|x|l <LUN:saveset> <wildcard>|@<filelist> [<options>]
  46.  
  47. Function:
  48. .........
  49.  
  50. a - create a new archive an add files to it
  51.  
  52. x - extract files from an existing archive
  53.  
  54. l - list directory of an existing archive
  55.  
  56. Tape identification
  57. ...................
  58.  
  59. LUN - local unit number of the tape drive (1-7), depends on the system
  60. configuration and will be displayed by the SCSI-BIOS at boot time
  61.  
  62. save-set - the number of the save set to work with (1,2,3,...). The saveset
  63. number must point to a saveset that exists (for options X and L) or to a
  64. saveset number which is one larger that the last existing saveset (for
  65. option a). If the a option is used on an existing saveset, that one and all
  66. subsequent savesets will be overwritten and all information will be lost.
  67.  
  68. Scope
  69. .....
  70.  
  71. wildcard - valid DOS wildcard to identify files in the current directory
  72.  
  73. @filelist - filename of a textfile containing the filenames to be archived.
  74. The sysntx is simple: one filename per line. The filenames should not
  75. include path information.
  76.  
  77. Options
  78. .......
  79.  
  80. LOG=<filename> - sets the error log to 'filename'. The default error report
  81. is printed on the screen. If the logfile exists, the text is appended to the
  82. existing file. 
  83.  
  84. WORDY=FALSE - default is TRUE, so this option turns off most of the
  85. informational messages that are usually displayed
  86.  
  87. TIMEDISP=FALSE - default is TRUE, so this option turns off the time in the
  88. error messages
  89.  
  90. TIMEOUT=<minutes> - sets the timeout period in minutes, if the tape does not
  91. respond to the program. In case of a timeout, the program will abort. A
  92. reasonable time is several minutes to give the drive time to recover from
  93. tracking problems or tape winding.
  94.  
  95. TAPE=<identifier> - sets the tape size. This is used to approximate the
  96. space left on the tape. Valid identifiers are for EXABYTE drives and
  97. include: P5-15, P5-30, P5-60, P5-90, P6-15, P6-30, P6-60, P6-90, P6-120
  98.  
  99. RESET=TRUE - will force an ASPI reset whenever Tarchive initializes the tape
  100. drive. The reset will slow the startup process by about one minute, but for
  101. unattended operation this option is highly reccomended to avoid lockups.
  102.  
  103. Compilation and Sources
  104. -----------------------
  105.  
  106. All programs require Borland/Turbo Pascal 6.0 and up to compile.
  107.  
  108. archiv.pas      basic file archiver: reads multiple files from disk and 
  109.         stores them with a directory in a single file
  110. tarchiv.pas    Exabyte/DAT tape archiver: uses ASPI calls to store
  111.         multiple files in single save sets on tape, includes
  112.         complete tape control
  113. terase.pas    Tape eraser: erases tapes, multiple erases possible for
  114.         tape conditioning
  115.  
  116. xxx.pas        units used by the above programs
  117.  
  118.  
  119. Data Format
  120. -----------
  121.  
  122. Each save set consists of a directory, the files and a filemark at the end.
  123.  
  124.     Saveset=Directory,File,File,...,File,Filemark
  125.  
  126. The directory is just another file containing reference information. It has
  127. to be the first file in the set. Its structure is as follows:
  128.  
  129.     Directory=Filename,Filesize,Filetime,Position
  130.  
  131.     Filename=STRING[12] 
  132.     Filesize=Longint
  133.     Filetime=Longint
  134.     Position=Longint
  135.  
  136. Files are the packages that get written:
  137.  
  138.     File=Header,Data,Checksum
  139.     
  140.     Header=MagicCode,Filename,Filesize,Filetime
  141.     Data=File (byte stream containing the data)
  142.     Checksum=Longint (sum of all data bytes)
  143.     
  144.     MagicCode=T#6archi#7 (7 bytes)
  145.     
  146. Tarchive uses fixed length blocks of 32 Kbytes size.
  147.  
  148. The Author
  149. ----------
  150.  
  151. Andreas Schiffler
  152.  
  153. 1230 11th St. E
  154. Saskatoon, Sask
  155. S7H 0G3
  156. Canada
  157.  
  158. Phone (306) 374-2431
  159. FAX (306) 652-7849
  160. e-mail: andreas@karlsberg.usask.ca
  161. e-mail: andreas@milo.usask.ca
  162. e-mail: schiffler@skisas.usask.ca
  163.  
  164.  
  165. -------------
  166.  
  167.     Copyright (C) 1994, 1995 by Andreas Schiffler.
  168.  
  169.     Permission to use, copy, modify, and distribute this software and its
  170.     documentation for any purpose and without fee is hereby granted, provided
  171.     that the above copyright notice appear in all copies and that both that
  172.     copyright notice and this permission notice appear in supporting
  173.     documentation.  This software is provided "as is" without express or
  174.     implied warranty.
  175.     ---------
  176.